home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 034a / ddjr10.zip / DDJR.DOC < prev    next >
Text File  |  1991-12-22  |  10KB  |  217 lines
  1.             * * * * * * * * * * * * * * * * * * * * * * * * *
  2.             *                                               *
  3.             *               DIAMOND DICE JR                 *
  4.             *                 VERSION 1.1                   *
  5.             *                   12/15/91                    *
  6.             *                                               * 
  7.             *                  Written By:                  *
  8.             *                 Michael Goetz                 *
  9.             *                                               *
  10.             *               Copyright (c)  1991             *
  11.             *               All Rights Reserved             *
  12.             *                                               *
  13.             *                 SUPPORT  BBS:                 *
  14.             *               The SpeakEasy BBS               *
  15.             *                 (407) 291-4626                * 
  16.             *         PCB 14.5 * HST D/S 1200-38,400        *
  17.             *                                               *
  18.             * * * * * * * * * * * * * * * * * * * * * * * * * 
  19.  
  20. INTRODUCTION
  21. ------------
  22.  DIAMOND DICE JR is a fun, addictive, fast-paced game door for
  23.  Bulletin Board Systems.  Playing the game is easy to learn. The
  24.  object of the game is to remove as many numbers from the DIAMOND
  25.  as you can,  and accumulate as many points as possible.  After
  26.  completing a game, scores are posted to the Top Score file and,
  27.  when registered, will be posted to a colorful graphic bulletin!
  28.  
  29. FEATURES
  30. --------
  31.  - ANSI color and Mono screens
  32.  - Supports up to 230k bps!
  33.  - Supports most BBS Software
  34.  - Supports Multi-node Systems
  35.  - Supports non-standard port & IRQ
  36.  - Supports FOSSIL drivers
  37.  - Easy installation and maintainance
  38.  - Creates graphic/non-graphic bulletin (Reg. Req.)
  39.  - Automatically maintained Bulletin/Top Score
  40.                               
  41. INSTALLATION
  42. ------------
  43.  Installation is very easy.  Create a directory to hold all the DIAMOND
  44.  DICE JR files and unzip DDJRxx.ZIP into this directory.
  45.  
  46.  Files should consist of:
  47.   DDJR10.EXE   .... Main program file
  48.   DDJSETUP.EXE .... Setup utility to create configuration file (DDICE.CFG)
  49.   DDJR.INS   ...... On-line Instruction file
  50.   DDJR.USR   ...... User file (NOTE: MUST have to operate game!)
  51.   DDJR       ...... Sample batch file (modify as needed)
  52.   DDJR.CFG   ...... Sample configuration file (read by DDSETUP.EXE)
  53.   DDJKILL.EXE ..... Bulletin - Top Score maintainance file
  54.   DDJR.DOC    ..... You're reading it!
  55.   REGISTER.FRM .... Please use it... I need the money !!   :-)
  56.   WHATSNEW.TXT .... History text file
  57.   FILE_ID.DIZ ..... Description file (for PCB 14.5a only)
  58.  
  59.  Change to the directory you created and run DDJSETUP.EXE and enter the
  60.  data in the fields as applicable to your system.  The first line will 
  61.  ask for the full path and filename of your BBS information file.  For
  62.  example: C:\PCB\PCBOARD.SYS.  DIAMOND DICE JR uses this information to
  63.  determine the BBS software which is being used as follows:
  64.  
  65.  PCBOARD.SYS   (PCBoard)
  66.  CALLINFO.BBS  (Wildcat!)
  67.  DOORS.SYS     (Spitfire)
  68.  DOOR.SYS      (GAP and other systems using std. DOOR.SYS)
  69.  DORINFOx.DEF  (QuickBBS/Remote Access)
  70.  
  71.  Line <4> will ask for the path and name for the Non-Graphic Bulletin 
  72.  file that will be created after each completed game.  The Bulletin 
  73.  will only be created with the REGISTERED VERSION.  Until registered, 
  74.  place "NONE" in this field.  
  75.  
  76.  Line <5> will ask for the path and name for the Graphic Bulletin file
  77.  that will be created after each completed game.  The Bulletins will
  78.  only be created with the REGISTERED VERSION.  Until registered, place
  79.  "NONE" in this field.
  80.  
  81.  Line <6> will ask for the registration code number.  Until the program
  82.  is registered, place 0000 in the Registration field.
  83.  
  84.  Line <7> will ask how many GAMES per day you wish to allow each user
  85.  (max. of 10).  NOTE: UNREGISTERED VERSION will only allow 2 games per
  86.  day.  Enter 2 in this field until registered.
  87.  
  88.  Line <8> asks for the total number of Top Scores to write to the
  89.  Top Score File and Bulletin.  NOTE: UNREGISTERED VERSION forces 5.
  90.  Until registered, please enter 5 into this field.
  91.  
  92.  NOTE: ALL FIELDS *MUST* BE FILLED IN OR PROGRAM FAILURE WILL OCCUR !!
  93.  ---------------------------------------------------------------------
  94.  
  95.  After entering all of the information, exit DDJSETUP.EXE by pressing
  96.  <S>ave....  This will create the DDJR.CFG file and place it in the
  97.  current directory.  
  98.  
  99.  Consult your BBS Software manual on how to create a DOOR batch file,
  100.  and modify the DDJR batch file supplied.  An example batch file for
  101.  PCBoard:
  102.  
  103.   @Echo off
  104.   C:
  105.   CD\PCB\DOORS\DDJR
  106.   DDJR10 DDJR.CFG         <---- This is the command line for calling
  107.   C:                            DIAMOND DICE JR. MUST BE THE SAME or 
  108.   CD\PCB                        failure will occur !!  For non-standard
  109.   BOARD.BAT                     port address and IRQ, see NOTE below!
  110.  
  111.  NOTE: If you need to specify a non-standard port address and IRQ,
  112.        then you will need to add this information to the BATCH file
  113.        calling DIAMOND DICE JR. The syntax is PORT:AAAA:X where AAAA is
  114.        the base address and X is the IRQ. An example batch file:
  115.  
  116.              @echo off
  117.              c:
  118.              cd\pcb\doors\ddjr
  119.              ddjr10 ddjr.cfg PORT:03E8:5  <---- NEW COMMAND LINE!
  120.              c:
  121.              cd\pcb
  122.              board.bat
  123.  
  124.        DIAMOND DICE JR will also support use of FOSSIL drivers. The
  125.        syntax for a FOSSIL driver is: PORT:F:P.  The 'F' tells the
  126.        door to use a Fossil driver for it's communications, and the 
  127.        'P' following it tells it which port to use for the Fossil.
  128.        Example: PORT:F:1 tells it to use a Fossil driver for port 1.
  129.  
  130.  DDJKILL.EXE is a utility that can be called from the EVENT.SYS (or the
  131.  equivalent for your BBS Software) that will automatically, on the 1st
  132.  of each month, create/update the "Last Month's Top Scorer" (which is
  133.  displayed on the Top Score screen and the Bulletin after registering). 
  134.  It will also delete the previous month's Top Scores (DDJR.SCR), making
  135.  DIAMOND DICE JR virtually maintainance free! It will only execute if run
  136.  on the 1st of the month.
  137.  
  138.  NOTE: DDJKILL.EXE can be forced to run by entering "DDJKILL /u" if desired.
  139.  WARNING: This will delete the Top Score file !!
  140.  
  141. MULTI-NODE SYSTEMS
  142. ------------------
  143.  When running more than one node, be sure to have a different configuration
  144.  for each node, and create a batch file for each node.  The configuration
  145.  file for each node can be created easily by entering at the dos prompt:
  146.  DDJSETUP DDJRx.CFG, where 'x' is the node number.   This will cause
  147.  DDJSETUP.EXE to create a configuration file under the name entered rather
  148.  than the default (DDJR.CFG).
  149.  
  150.  Example DDJR2.BAT file:           Example DDJR2.CFG:
  151.  ------------------------           -------------------
  152.  @echo off                         <1> c:\pcb2\pcboard.sys  <--- path to
  153.  c:                                <2> The SpeakEasy BBS         node 2
  154.  cd\pcb\doors\DDJR                 <3> Michael Goetz             system
  155.  DDJR10 DDJR2.CFG                      ....and so on             file.
  156.  c:
  157.  cd\pcb2
  158.  board2.bat
  159.  
  160. REGISTRATION !!
  161. ---------------
  162.  Registration is required if you choose to continue using this door
  163.  program after a 3 or 4 week evaluation period.  When registered, the
  164.  "[UNREGISTERED EVALUATION COPY]" line will be replaced with the name
  165.  of your BBS followed by the SysOp name as well as the removal of the 
  166.  delay built into the opening and closing screens.  Registration will
  167.  also allow you the following features:
  168.  
  169.  -- Creation of a colorful graphic Top Score Bulletin which is updated
  170.     after each completed game.
  171.  -- The total number of Top Scores posted can also be specified in the
  172.     configuration file (maximum of 50).
  173.  -- The amount of GAMES allowed each user per day (max of 10) can be
  174.     specified in the configuration file.
  175.  -- The amount of CHANCES (0-6) each player is given at game start can
  176.     be specified in the configuration file.
  177.  
  178.  To register your copy of DIAMOND DICE JR, please fill out the supplied
  179.  registration form (REGISTER.FRM) and mail it along with a small
  180.  donation of $20.00 or $25.00 (check or Money Order) payable to
  181.  Michael Goetz, address on the form.   Please be sure you enter the
  182.  information on the form as it appears in the DDJR.CFG file.   Your
  183.  registration code is based upon this information!
  184.  
  185.  After receiving your registration form, I will pre-register you on the
  186.  SpeakEasy BBS.  You will then be able to call the SpeakEasy and receive
  187.  your registration code. Please allow at least 7 days prior to calling.
  188.  If you prefer, I will mail your registration code if you supply a self-
  189.  addressed stamped envelope.   PLEASE SUPPORT SHAREWARE!!
  190.    
  191. APPRECIATION
  192. ------------
  193.  I would like to thank Steve Page, SysOp of the SpeakEasy BBS, and Jim
  194.  Murphey, SysOp of the Coffee Shop BBS, for beta testing the program. 
  195.  Their assistance in the development of DIAMOND DICE JR is sincerely
  196.  appreciated.
  197.  
  198. SUPPORT
  199. -------
  200.  If you have any questions concerning the setup or operation of
  201.  DIAMOND DICE JR, I can be reached via email thru PCRelay's (RIME)
  202.  BBS-DOORS conference or at The SpeakEasy BBS, Majic Software's
  203.  support BBS.
  204.  
  205. LEGALITIES
  206. ----------
  207.  THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  208.  WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  209.  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  210.  IN NO EVENT SHALL THE AUTHOR OR ANYONE INVOLVED WITH THE CREATION AND PRO-
  211.  DUCTION OF THIS PRODUCT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR
  212.  CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OF THIS PROGRAM.  YOUR USE OF 
  213.  THIS PROGRAM CONSTITUTES YOUR AGREEMENT TO THIS DISCLAIMER AND YOUR RELEASE
  214.  OF THE AUTHOR FROM ANY FORM OF LIABILITY OR LITIGATION.
  215.  
  216.                                 - END - 
  217.